This change mirrors aspnetcore PR 62619 by adding two new properties to the sdk section of global.json:

• paths: [ ".dotnet", "$host$" ] - Instructs the .NET CLI to probe the repository-local .dotnet directory before falling back to host locations, enabling automatic use of the pinned local SDK without requiring manual PATH modifications.

• errorMessage: Provides clear guidance to developers when the SDK is missing, directing them to run the appropriate restore script (./restore.sh for Linux/macOS or ./restore.cmd for Windows).

Benefits

1. Improved Developer Experience: Developers no longer need to manually configure their PATH or DOTNET_ROOT to use the pinned SDK version.
2. Automatic SDK Resolution: The .NET CLI will automatically find and use the local SDK installation in the .dotnet directory.
3. Better Error Messaging: When the local SDK is missing, developers get actionable guidance instead of generic error messages.
4. Consistency: Aligns with the same approach being used in the aspnetcore repository.

Changes

The modification is minimal and surgical - only two properties were added to the existing sdk section:

 "sdk": {
   "version": "10.0.100-preview.5.25277.114",
   "rollForward": "major",
-  "allowPrerelease": true
+  "allowPrerelease": true,
+  "paths": [ ".dotnet", "$host$" ],
+  "errorMessage": "The .NET SDK could not be found. Run ./restore.sh (Linux/macOS) or ./restore.cmd (Windows) to install the local SDK."
 },

All other sections (tools, runtimes, msbuild-sdks) remain completely unchanged, and the existing SDK version and configuration are preserved.

Verification

• ✅ Build system continues to work with the pinned SDK version
• ✅ Local .dotnet directory is correctly prioritized for SDK resolution
• ✅ Fallback to host SDK works when local SDK is unavailable
• ✅ JSON syntax is valid
• ✅ No impact on existing tools, runtimes, or MSBuild SDK configurations

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.